Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 5 - Menu Manager Reference / Menu Manager Functions

Manipulating and Accessing Menu Item Characteristics /

SetMenuItemKeyGlyph

NEW WITH THE APPEARANCE MANAGER

Substitutes a keyboard glyph for that normally displayed for a menu item's keyboard equivalent.

pascal OSErr SetMenuItemKeyGlyph (
                     MenuHandle inMenu,
                     SInt16 inItem,
                     SInt16 inGlyph)

inMenu

The handle to the menu structure of the menu item for which you wish to substitute a keyboard glyph.

inItem

An integer representing the item number of the menu item for which you wish to substitute a keyboard glyph.

inGlyph

An integer representing the substitute glyph to display for characters that don't match their designated character codes. Pass 0 if you wish no substitution to occur. For a description of keyboard glyphs and a list of the keyboard font character codes, see "The Extended Menu Resource".

function result

A result code; see "Result Codes".

DISCUSSION

The SetMenuItemKeyGlyph function overrides the character that would normally be displayed in a menu item's keyboard equivalent with a substitute keyboard glyph. This is useful if the keyboard glyph in the font doesn't match the actual character generated. For example, you might use this function to display function keys.

SEE ALSO

"Appearance Manager Gestalt Selector Constants".

GetMenuItemKeyGlyph.